home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / peer_encaps.z / peer_encaps
Encoding:
Text File  |  1998-10-20  |  5.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppeeeeeeeerrrr____eeeennnnccccaaaappppssss((((1111MMMM))))                                                ppppeeeeeeeerrrr____eeeennnnccccaaaappppssss((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      peer_encaps - Simple Network Management Protocol Agent Encapsulator
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////ppppeeeeeeeerrrr____eeeennnnccccaaaappppssss [ ----tttt _t_r_a_p_P_o_r_t ]
  13.                           [ ----ssss _s_e_n_d_P_o_r_t ]
  14.                           [ ----hhhh _h_o_s_t ]
  15.                           [ ----pppp _p_o_r_t ]
  16.                           [ ----wwww _w_a_i_t ]
  17.                           [ ----cccc _c_o_n_f_i_g_F_i_l_e ]
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _p_e_e_r__e_n_c_a_p_s is a daemon which provides a way to encapsulate proprietary
  21.      SNMP agents, and an integrated environment for hosts that also run an
  22.      off-the-shelf or custom, non-extensible SNMP Agent or proxy.
  23.  
  24.      The _p_e_e_r__s_n_m_p_d(1m) daemon implements the Simple Network Management
  25.      Protocol (SNMP).  Since only a single SNMP Agent can be listening to the
  26.      standard SNMP port (UDP port 161), this limits a Manager to access only
  27.      variables associated with one agent.  The _p_e_e_r__e_n_c_a_p_s daemon provides a
  28.      mechanism to overcome this problem.
  29.  
  30.      The _p_e_e_r__s_n_m_p_d agent is configured to listen at UDP port 161, so that it
  31.      receives ALL SNMP queries.  The other proprietary SNMP Agents are invoked
  32.      listening at alternate ports, not at 161.  The _p_e_e_r__e_n_c_a_p_s daemon is
  33.      configured to recognize these SNMP Agents, the alternate port number at
  34.      which they are listening, and the sub-trees (a sub-tree is a set of MIB
  35.      variables subordinate to a node in the naming tree) they are managing.
  36.      When the _p_e_e_r__e_n_c_a_p_s daemon is started up, it reads a configuration file
  37.      containing all this information, and connects to the _e_e_r__s_n_m_p_d
  38.      daemon, informing about these sub-trees.
  39.  
  40.      When the _p_e_e_r__s_n_m_p_d daemon receives a SNMP request corresponding to a
  41.      subtree associated with an encapsulated agent, it passes on them to the
  42.      _p_e_e_r__e_n_c_a_p_s daemon, which converts the requests into SNMPv1 packets, and
  43.      sends the packets to the specific Agent at the specific alternate port.
  44.  
  45.      The reverse is true for the responses and traps.
  46.  
  47.      The _p_e_e_r__s_n_m_p_d and _p_e_e_r__e_n_c_a_p_s daemons use SMUX protocol to communicate
  48.      between each other.  Please refer to RFC 1227 for more information on the
  49.      SMUX protocol.
  50.  
  51. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  52.      _----_tttt _tttt_rrrr_aaaa_pppp_PPPP_oooo_rrrr_tttt
  53.           The incoming trap port where peer_encaps listens to receive SNMP
  54.           traps sent by encapsulated agents.
  55.  
  56.           Default : no traps forwarded
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppeeeeeeeerrrr____eeeennnnccccaaaappppssss((((1111MMMM))))                                                ppppeeeeeeeerrrr____eeeennnnccccaaaappppssss((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      _----_ssss _ssss_eeee_nnnn_dddd_PPPP_oooo_rrrr_tttt
  75.           The port from which peer_encaps sends requests to the encapsulated
  76.           agents, and to which the encapsulated agents send their responses.
  77.  
  78.           Default : Assigned by the host
  79.  
  80.      _----_hhhh _hhhh_oooo_ssss_tttt
  81.           The address of the host where the peer_snmpd daemon is running,
  82.           normally the same host where the peer_encaps daemon is running.
  83.  
  84.           Example : -h 192.146.153.3
  85.           Default : localhost
  86.  
  87.      _----_pppp _pppp_oooo_rrrr_tttt
  88.           The SMUX port number to which peer_encaps sends its SMUX traffic.
  89.  
  90.           Default : /etc/services SMUX port, if provided ; else 199.
  91.  
  92.      -_w _w_a_i_t
  93.           The timeout in seconds, for the SNMP response from the encapsulated
  94.           agent.
  95.  
  96.           Default : 2 seconds
  97.  
  98.      _----_cccc _cccc_oooo_nnnn_ffff_iiii_gggg_FFFF_iiii_llll_eeee
  99.           The full path name of the configuration file.  For details on the
  100.           format of this configuration file, please see peer_encaps_config(4).
  101.  
  102.           Default : /etc/peer_encaps_config
  103.  
  104. FFFFIIIILLLLEEEESSSS
  105.      /usr/etc/peer_encaps
  106.      /etc/peer_encaps_config
  107.  
  108. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  109.      _pppp_eeee_eeee_rrrr______ssss_nnnn_mmmm_pppp_dddd(1m), _pppp_eeee_eeee_rrrr______ssss_nnnn_mmmm_pppp_dddd______cccc_oooo_nnnn_ffff_iiii_gggg(4), _pppp_eeee_eeee_rrrr______eeee_nnnn_cccc_aaaa_pppp_ssss______cccc_oooo_nnnn_ffff_iiii_gggg(4)
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.